home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / docs / howto / doADump < prev    next >
Encoding:
Text File  |  1992-12-14  |  7.3 KB  |  154 lines

  1.  
  2. Procedure for doing a dump (revised $Date: 92/06/05 13:11:17 $).
  3.  
  4. Right now the dumping procedure is kind of labor intensive.  
  5.  
  6. Finding a tape:
  7.  
  8. A level 0 (weekly) dump will take about 2 tapes (4 tapes using the old
  9. Exabyte 8200's).  A single tape can hold about a week's worth of level
  10. 1 (daily) dumps.  Tapes are stored in 608-2 Evans. Some are in the
  11. tape holder on the wall, more are in the file cabinet.  Here is the
  12. method for reusing tapes.  Daily dumps can be reused if there have
  13. been two weekly dumps done since they were created, although you'll
  14. want to save them as long as possible. That way we don't lose anything
  15. should a single weekly dump be unreadable.  Weekly dumps are saved for
  16. a month, and every sixth weekly dump set is saved forever.  After that
  17. weekly dump tapes can be reused as well.  A database of what tapes
  18. were used for and when is kept in /sprite/admin/dump/dumpdates.
  19.  
  20. The tapes in the tape holder are stored in chronological order
  21. left-to-right, like a circular buffer.  Weekly dump tapes have
  22. rubberbands around them.  The most current weekly dump has a paperclip
  23. in the rubberband.  Older tapes are kept in the filing cabinet.  The
  24. boxes marked "reuse" are ok for using.  Boxes marked "weekly" are for
  25. weekly dump tapes.  The box marked "bad" contains defective tapes that
  26. can be given away. When you clean out a slot in the tape holder put
  27. the daily dump tapes in a reuse box.  If you are cleaning out the
  28. upper left slot the weekly tapes go into a weekly box.  For any other
  29. slot the weekly tapes go into a reuse box.  We should probably put
  30. tapes into one box and get them to use from another so that tapes
  31. don't get overwritten right away.
  32.  
  33. Finding a drive:
  34.  
  35. There are currently two drives being used for backups.  To avoid
  36. problems with server crashes, they are generally hooked up to a client
  37. machine, often the home machine of the person doing the dumps.  If you
  38. move the drives, you must edit the crontab of the new and old hosts so
  39. that the right machine does the daily dumps (see "Daily dumps" below).
  40. The drives are named /dev/rst04.nr and /dev/rst05.nr.
  41.  
  42. Putting the tape in the drive:
  43.  
  44. Push the button on the exabyte.  After about 30 seconds the door will
  45. open.  Make sure the red write-protect slider on the tape is not visible.
  46. Put in the new tape and close the door.  Wait about 30 seconds
  47. and the green light will go on.  Now you're ready to go.  While the tape
  48. is being accessed the red light will flicker.
  49.  
  50. Initializing a tape:
  51.  
  52. Once you have found a tape you need to initialize it.
  53. Notes: you must wait until the green light goes on before initializing.
  54. You must be root to do the initialization.
  55.  
  56. a) Initializing a blank tape
  57.  
  58. If it is a blank tape use the command "dump -i <tape#> -f <device>".
  59. (See "Finding a drive" above for the list of device names.)  The next
  60. tape number can be determined from the dumpdates file.  In the long
  61. run, you can just look for the last "Initializing" line.  For the time
  62. being, though, you should verify that there aren't any "Initializing"
  63. lines with a higher tape number than the one you plan to use.
  64.  
  65. b) Initializing an old tape
  66.  
  67. If you're reusing a tape use "dump -r -f <device>".  Make sure the
  68. device you use is a "norewind" tape device.
  69.  
  70. Daily dumps:
  71.  
  72. Daily dumps are done via the script /sprite/admin.$MACHINE/dailydump.
  73. This script is run every night by cron.  It will send mail to "dumper"
  74. when it completes or if there are errors.  If the machine doing the
  75. dumps crashes while the dumps are in progress, "dumper" will get mail
  76. with an error message when it reboots.  If this happens, you will need
  77. to start a new tape.  This is because the dump program gets confused
  78. by the partial file at the end of the tape, at least when used with an
  79. 8500 tape drive.
  80.  
  81. You can also check /sprite/admin/dump/dumplog for error messages.  You
  82. can use /sprite/admin.$MACHINE/dumpsize to get an idea when the daily
  83. tape is about to fill up.
  84.  
  85. If you take over as dumper during the middle of the week, you should
  86. edit /sprite/admin/dump/dumpalias by hand (so that it names you
  87. instead of the old dumper).  If your first job as dumper is to run the
  88. weekly dumps, the weekly dump script will change the dumpalias file
  89. for you.
  90.  
  91. Weekly dumps:
  92.  
  93. 1. Log in as yourself to the machine with the drives, su to root, and
  94. run "/sprite/admin.$MACHINE/weeklydump -i".  This will initialize the
  95. tape in the drive and start the dumps.  This will disable the daily
  96. dumps by creating a lockfile "/sprite/admin/dump/doingweekly".  This
  97. will also change the dumper alias to your userid.  You should either
  98. run it from the console or run it with stdout and stderr redirected to
  99. a file or /dev/null.  If you run it from, e.g., an rlogin shell
  100. without redirecting the output, the dump will abort when you log out.
  101. If something goes wrong with the weekly dump and you want to start over
  102. again, you will need to run "weeklydump startFs" where startFs is the first
  103. file system that you wish to start dumping.  Otherwise, it will start dumping
  104. from the file system after the last successfully dumped file system.
  105.  
  106. 2. When the tape on one drive fills up, the dumps will automatically
  107. resume using the next drive in the tape list (see
  108. /sprite/admin/dump/tapelist).  If the dumps exhaust the list of tapes,
  109. the weeklydump script will send mail to "dumper", saying that the
  110. dumps need attention and giving the name of the next filesystem that
  111. needs to be dumped.  (Alternatively, you can look in the dumplog or
  112. dumpdates files to see which filesystem couldn't be dumped.)  With the
  113. old 8200's it took 10-12 hours to write the first two tapes.  With the
  114. 8500's it takes about 15 hours to do the complete dumps (on two
  115. tapes).  If the drives do run out, replace the tapes with new ones.
  116. Rerun "weeklydump -i".  It will look in the lock file to determine the
  117. next directory to dump and resume dumping.
  118.  
  119. As with the daily dumps, "dumper" will get mail in case of errors,
  120. crashes, or completion of the dumps.
  121.  
  122. 3. One the dumps are complete, label the tapes (with the date and what
  123. filesystems they contain).  Put another tape in the first drive (the
  124. one listed first in /sprite/admin/dump/tapelist) and reenable the
  125. daily dumps with "dailydump -i".
  126.  
  127. Cleaning a tape drive:
  128.  
  129. The tape drives should be cleaned once a quarter, using the drive
  130. cleaning kits in the filing cabinet in 608-2.  Each kit is good for
  131. three cleanings.  When you start a new kit, mark both the cartridge
  132. and the bottle with the drive that you are cleaning them with.  Also
  133. write down the date of the cleaning on the cartridge.  When reusing a
  134. kit, use the cartridge and bottle that are labeled for the drive you
  135. want to clean.  (And of course write down the date on the cartridge.)
  136. Specific instructions on how to use the kit are in with the cartridge.
  137.  
  138. Tape errors:
  139.  
  140. Occasionally the dumps will fail due to some problem with the tape
  141. drive.  There should be a syslog message from the tape driver which
  142. contains some magic numbers detailing the failure.  To look up the
  143. meaning of the numbers, check out Appendices C and D of the Exabyte
  144. 8500 User's Manual.  The "sense code" and "qualifier" in the syslog
  145. message correspond to the ASC and ASCQ numbers in Appendix C.
  146. Unfortunately, you have to guess what the Sense Key was.  The "symptom
  147. code" in the syslog message corresponds to the FSC numbers in Appendix
  148. D.
  149.  
  150. Other documentation:
  151.  
  152. You may also wish to read the man pages for the following programs and
  153. scripts: dump, dailydump, weeklydump.
  154.